home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / icon.lzh / ICONJUGL.TXT < prev   
Text File  |  1992-03-25  |  11KB  |  274 lines
  1.  
  2.  =========================================================================
  3.   ***********************************************************************
  4.  =========================================================================
  5.  
  6.  
  7.                Icon Juggler - Version 1.2
  8.  
  9.                User Documentation
  10.                ------------------
  11.  
  12.                Software and Documentation
  13.                by John Eidsvoog
  14.                Copyright 1992 CodeHead Technologies
  15.                Revision: Wednesday, March 25, 1992
  16.  
  17.                Icon Juggler is part of the TEC
  18.                Utilities Disk and is included with the
  19.                purchase of the TOS Extension Card
  20.                (TEC) or the TOS 2.06 chips (when
  21.                purchased from CodeHead Technologies). 
  22.  
  23.                If you have not purchased the TEC or
  24.                the TOS chips from CodeHead, Icon
  25.                Juggler is shareware and you should
  26.                register your copy by sending $15 to
  27.                John Eidsvoog at the address listed
  28.                below. 
  29.  
  30.  
  31.  =========================================================================
  32.   ***********************************************************************
  33.  =========================================================================
  34.  
  35.  
  36.  ------------
  37.   What it is
  38.  ------------
  39.  
  40. Icon Juggler lets you create your own set of icons for Atari's NewDesk. 
  41. The desktop uses the icons contained in the file DESKICON.RSC.  You can
  42. load icons from any popular format and save them as your own personalized
  43. set. 
  44.  
  45.  
  46.  -------------------------
  47.   Installing Icon Juggler
  48.  -------------------------
  49.  
  50. Icon Juggler is a standard Atari program and you can run it from any
  51. location (hard disk or floppy) by double-clicking on it or starting it
  52. from a program launcher.  It does not function as an accessory at this
  53. time.  It will run on any ST/TT in any resolution.
  54.  
  55.  
  56.  --------------------
  57.   Using Icon Juggler
  58.  --------------------
  59.  
  60. Icon Juggler is very intuitive.  There is a Help screen available when
  61. you press the Help key.  All functions are available from either the
  62. drop-down menus or as keypresses (selecting icons can only be done with
  63. the mouse).
  64.  
  65. When Icon Juggler first runs, it looks on your boot drive for
  66. DESKICON.RSC and will load that file if it finds it.  It also looks for
  67. NEWDESK.INF, and if that is found, you'll see check marks by any icons
  68. that are currently being used by your desktop.
  69.  
  70. The GEM desktop assigns its icons by number (see "Numbers in Hex" below). 
  71. For this reason, if you change the order of your icons or insert new ones,
  72. and save the file as DESKICON.RSC, you'll be reassigning the icons for
  73. your desktop.  If you double-click on an icon, a box will appear listing
  74. the first five applications which are defined for that icon (or an alert
  75. box telling you that none are assigned).  You should try not to disturb
  76. the order of the icons that are currently defined or you will have to
  77. reassign them from the desktop.  Alternatively, you can use the editing
  78. features of Icon Juggler to make sure that your icons are assigned the way
  79. you want them. 
  80.  
  81. Icon Juggler runs in a window.  You may use standard mouse operations to
  82. resize, move, or scroll the window.  The title line of the window will
  83. show the name of the current file.  The name will be updated when you
  84. load or save a set of icons.  If you append, the title will not change. 
  85. The info line of the window will show the total number of icons loaded,
  86. the number selected, and the number in the paste buffer. 
  87.  
  88.  
  89.  -----------------
  90.   Selecting Icons
  91.  -----------------
  92.  
  93. You can select icons by clicking on them with the mouse.  If you hold the
  94. mouse down and drag it, the icons will be selected in a block fashion,
  95. much like a word processor.  If you move up or down by rows, all of the
  96. icons in between will be selected.  Dragging the mouse above or below the
  97. window will cause it to automatically scroll and select. 
  98.  
  99. Deselecting icons is done in the same manner.  If you click on an icon
  100. that is already selected, it will be deselected.  The function of the
  101. mouse (selecting or deselecting) is determined by the state of the first
  102. icon upon which you've clicked.  While holding the button down, all
  103. icons in the block area will assume the state of this first icon,
  104. regardless of their previous state.  That is, when you are selecting and
  105. you pass over selected icons, they will remain selected instead of
  106. becoming deselected. 
  107.  
  108.  
  109.  
  110.  ---------
  111.   Options
  112.  ---------
  113.  
  114. Icon Juggler... [Help]
  115.  
  116. A screen will appear, listing the keyboard commands and brief
  117. instructions on using Icon Juggler.
  118.  
  119.  
  120. Load:           [L]
  121. -------------------
  122.  
  123. Icon Juggler will load any icon file with the following extensions: RSC,
  124. ICE, NIC, or ICN file.  Loading will replace any existing icons you have
  125. loaded.  Up to 500 icons may be loaded at once.  Choose the file you
  126. want to load with the file selector.  Due to the format of some icon
  127. files, there's no way for Icon Juggler to be sure that you've selected a
  128. valid icon file.  If you select a non-icon file, you will see a number
  129. of icons shown as garbage on the screen.  If this happens, you can
  130. simply select them and delete them.
  131.  
  132.  
  133. Append:         [Control-L]
  134. ---------------------------
  135.  
  136. Appending is just like loading except that the icons will be added to
  137. the end of the current set of icons.  If the number of icons exceeds
  138. 500, the remainder of the append operation will be aborted.
  139.  
  140.  
  141. Save:           [S]
  142. -------------------
  143.  
  144. This allows you to save the current set of icons.  They will be saved as
  145. a resource file (RSC).  Although up to 500 icons can be loaded into Icon
  146. Juggler, only the first 200 will be saved.  This is due to a limitation
  147. of RSC files, which must be under 64K in length.  You can save the file
  148. under any name, allowing you to create a library of icons.  Saving with
  149. the name DESKICON.RSC in the root of your boot drive will replace your
  150. current set of icons for the desktop.
  151.  
  152.  
  153. Save Selected:  [Control-S]
  154. ---------------------------
  155.  
  156. This option will save the current set of selected icons as an RSC file,
  157. allowing you to save subsets of the loaded set of icons.  In the
  158. process, a "Copy" operation will be performed, replacing the icons in
  159. the paste buffer with the selected set. 
  160.  
  161.  
  162. Quit:           [Q or Esc]
  163. --------------------------
  164.  
  165. An alert box will ask you if you want to exit, allowing you to return to
  166. Icon Juggler or exit.
  167.  
  168.  
  169. New:            [N, Alt-N, ClearHome]
  170. -------------------------------------
  171.  
  172. This will clear the window of all icons without warning.
  173.  
  174.  
  175. Select All:     [A or Alt-A]
  176. ----------------------------
  177.  
  178. This will select all of the icons currently loaded.
  179.  
  180.  
  181. Deselect All:   [D or Alt-D]
  182. ----------------------------
  183.  
  184. This will deselect all selected icons.
  185.  
  186.  
  187. Cut:            [X, Alt-X, Delete]
  188. ----------------------------------
  189.  
  190. This will move all selected icons into the paste buffer.  They will be
  191. deleted from the current window.  Previous items in the paste buffer
  192. will be lost.
  193.  
  194.  
  195. Copy:           [C or Alt-C]
  196. ----------------------------
  197.  
  198. This will copy all selected icons into the paste buffer, but they will
  199. remain in the current window.  Previous items in the paste buffer will
  200. be lost.
  201.  
  202.  
  203. Paste:          [V, Alt-V, Insert]
  204. ----------------------------------
  205.  
  206. All icons in the paste buffer will be appended to the end of the current
  207. set of icons.  If you want to insert icons somewhere other than the end
  208. of the set, you can hold down either Shift key and click the mouse on an
  209. icon.  The icons in the paste buffer will be inserted at the point of
  210. the icon upon which you clicked and the rest of the icons will be pushed
  211. down. 
  212.  
  213.  
  214. Numbers in Hex: [H]
  215. -------------------
  216.  
  217. Selecting "Numbers in Hex" will switch the icon numbering system between
  218. decimal and hexadecimal (base 16).  When there is no check mark in front
  219. of this option, the icons will be numbered in decimal starting with number
  220. one.  If there is a check mark, the icons will be numbered in hexadeci